Interrupt 21h Function 7160h Minor Code 0h
Retrieves the
full path for the specified file or path.
mov ax, 7160h
mov cl, 0 ; Get Full Path Name
mov ch, SubstExpand ; see below
mov si, seg SourcePath ; see below
mov ds, si
mov si, offset SourcePath
mov di, seg DestPath
; see below
mov es, di
mov di, offset DestPath
int 21h
jc error
Parameters
SubstExpand
Flag that
indicates whether the returned path should contain a SUBST drive letter or the
path associated with the SUBST drive. Zero is specified to indicate that the
returned path should contain the path associated with the SUBST drive, and 80h
is specified to indicate that the returned path should contain the SUBST drive
letter.
SourcePath
Address of a
null-terminated string that names the file or path to retrieve the full path
for. Either the long filename or the standard 8.3 filename format is
acceptable.
DestPath
Address of
the buffer that receives the full path. The buffer should be large enough to
contain the largest possible Windows 95 path (260 characters, including the
drive letter, colon, leading backslash, and terminating null character).
Return Value
Clears the
carry flag, modifies the AX register, and returns the full path in the given
buffer if successful. Otherwise, the function sets the carry flag and sets the
AX register to an error value.
Remarks
When just a
filename is specified, this function merges the name of the current drive and
directory with the specified filename to determine the full path. Relative
paths containing the characters . and .. in SourcePath are fully expanded. The function
does no validation, so the specified filename or path does not need to exist.